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1.1 INTRODUCTION 


EEE 
1.2 MODES OF 
OPERATION 


EEE 
1.3 LINE FORMAT 
AND LINE NUMBERS 


1. GENERAL INFORMATION ABOUT MS-BASIC 


MS-BASIC is the most extensive implementation of MS-BASIC available 
for microprocessors. MS-BASIC meets the ANSI qualifications for 
MS-BASIC, as set forth in document BSRX3.60-1978. Each release of 
MS-BASIC is compatible with previous versions. 


The manual is divided into three large chapters and nine appendixes. 
Chapter 1 covers a variety of topics, largely pertaining to data 
representation in MS-BASIC. Chapter 2 contains the syntax and 
semantics of every command and statement in MS-BASIC, ordered 
alphabetically. Chapter 3 describes all of MS-BASIC's intrinsic 
functions, also ordered alphabetically. The appendixes tell how to use 
MS-BASIC on the computer and its two operating systems, CP/M-86 
and MS-DOS. They also contain a list of error messages and codes, 
a list of mathematical functions, and a list of ASCII character codes. 


When MS-BASIC is initialized, it types the prompt "OK". "Ok" means 
MS-BASIC is at command level — that is, it is ready to accept 
commands. At this point, MS-BASIC may be used in either of two 
modes: the direct mode or the indirect mode. 


In the direct mode, MS-BASIC statements and commands are not 
preceded by line numbers. They are executed as they are entered. 
Results of arithmetic and logical operations may be displayed 
immediately and stored for later use, but the instructions themselves 
are lost after execution. This mode is useful for debugging and for 
using MS-BASIC as a “calculator” for quick computations that do not 
require a complete program. 


The indirect mode is the mode used for entering programs. Program 
lines are preceded by line numbers and are stored in memory. The 
program stored in memory is executed by entering the RUN 
command. 


Program lines in a MS-BASIC program have the following format 
(square brackets indicate something that is optional): 


nnnnn BASIC statement [:BASIC statement... ] <RET> 


At the programmer's option, more than one MS-BASIC statement may 

be placed on a line, but each statement on a line must be separated 

from the last by a colon. A MS-BASIC program line always begins with 
a line number, ends with a carriage return, and may contain up to of 

255 characters. 


It is possible to extend a logical line over more than one physical line 
by use of the ALT-J key. ALT-J lets you continue typing a logical line 
on the next physical line without entering a <RET> 


Every MS-BASIC program line begins with a line number. Line 
numbers indicate the order in which the program lines are stored in ho) 
memory and are used as references when branching and editing. 

Line numbers must be in the range O to 65529. A period (.) may be 

used in EDIT, LIST, AUTO and DELETE commands to refer to the 

current line. 


ee 

1.4 CHARACTER SET The MS-BASIC character set is comprised of alphabetic chara dters, 
numeric characters and special characters. The alphabetic characters 
in MS-BASIC are the uppercase and lowercase letters of the alphabet. 
The numeric characters are the digits 0 through 9. 


1.4.1 SPECIAL The following special characters and terminal keys are recognized by 
CHARACTERS AND MS-BASIC: 
TERMINAL KEYS 


Table 1-1: MS-BASIC Special Characters and Terminal Keys 


CHARACTER NAME 
Blank 
= Equal sign or assignment symbol 
+ Plus sign 
- Minus sign 
å Asterisk or multiplication symbol 
/ Slash or division symbol 


Up arrow or exponentiation symbol 

Left parentheses 

Right parenthesis 

Percent 

Number (or pound) sign 

Dollar sign 

Exclamation point 

Left bracket 

Right bracket 

Comma 

Period or decimal point 

Single quotation mark (apostrophe) 
Semicolon 

Colon 

Ampersand 

Question mark 

Less than 

Greater than 

Backslash or integer division symbol 

At-sign - 
= Underscore 

backspace Deletes last character typed. 
<escape> Escapes Edit Mode subcommands. 
See Section 2.16. 


OVAS: - 


<tab> Moves print position to next tab stop. 
Tab stops are every eight columns. 
ALT-J Moves to next physical line. 
<carriage return> Terminates input of a line. 


eene 


1.4.2 ALTERNATE The following alternate characters are in MS-BASIC: 
CHARACTERS 
ALT-A Enters Edit Mode on the line being typed. 
ALT-C Interrupts program execution and returns to 


MS-BASIC command level. 


ALT-G Rings the bell at the terminal. 
ALT-H Backspace. Deletes the last character typed. 
ALT -! Tab. Tab stops are every eight columns. 
ALT-R Retypes the line that is currently being typed. 
ALT-S Suspends program execution. 
ALT -Q Resumes program execution after ALT-S. 
ALT -U Deletes the line that is currently being typed. 
45 CONSTANTS Constants are the actual values MS-BASIC uses during execution. 


There are two types of constants: string and numeric. 


A string constant is a sequence of up to 255 alphanumeric 
characters enclosed in double quotation marks. Examples of string 
constants: 


Example: 


“HELLO” 
“$25,000.00” 
“Number of Employees" 


Numeric constants are positive or negative numbers. Numeric 
constants in MS-BASIC cannot contain commas. There are five types 
of numeric constants: 


1. Integer constants Whole numbers between -32768 and 
+32767. Integer constants do not have 
decimal points. 


2. Fixed Point Positive or negative real numbers, 
constants ie., numbers that contain decimal points. 

3. Floating Point Positive or negative numbers represented 
constants in exponential form (similar to scientific 


notation). A floating point constant 
consists of an optionally signed integer or 


1.5.1 SINGLE-AND 
DOUBLE-PRECISION 
FORM FOR NUMERIC 
CONSTANTS 


fixed point number (the mantissa) 
followed by the letter E and an optionally 
signed integer (the exponent). The 
allowable range for floating point 
constants is 10-38 to 10+38. 

Examples: 


235.9881E-7 = .00002359881 
2359E6 = 2359000000 


(Double precision floating point constants 
use the letter D instead of E. See Section 
1.5.1.) 


4. Hex constants Hexadecimal numbers with the prefix &H. 
Examples: 


8 H76 
8 H32F 


5. Octal constants Octal numbers with the prefix &0 or &. 
Examples: 


&0347 
&1234 


Numeric constants may be either single-precision or double-precision 
numbers. Single-precision numeric constants are stored with 7 digits 
of precision, and printed with up to 7 digits. With double precision, the 
numbers are stored with 16 digits of precision, and printed with up to 
16 digits. 


A single-precision constant is any numeric constant that has: 
» Seven or fewer digits 

» Exponential form using E 

» A trailing exclamation point (!) 

A double-precision constant is any numeric constant that has: 
» Eight or more digits 

» Exponential form using D 


> A trailing number sign (+) 


AA E 
1.6 VARIABLES 


1.6.1 VARIABLE 
NAMES AND 
DECLARATION 
CHARACTERS 


EXAMPLES: 


A A — A AAA A A A A O 
Table 1-2: Single- and Double-Precision Form Constants 


Examples 
SINGLE-PRECISION DOUBLE-PRECISION 
CONSTANTS CONSTANTS 
468 345692811 
-1.09E-06 -1.09432D-06 
3489.0 3489.0# 
22.5! 7654321.1234 


Variables are names used to represent values that are used in a 
MS-BASIC program. The value of a variable may be assigned while 
designing a program, or it may be assigned as the results of 
calculations performed by a program. Before a variable is assigned a 
value, its value is assumed to be zero. 


MS-BASIC variable names may be any length up to 40 characters. Å 
variable name may contain letters and numbers, and the decimal 
point. The first character must be a letter. Special type declaration 
characters are also allowed — see below. 


A variable name may not be a reserved word, but embedded 
reserved words are allowed. If a variable begins with FN, it is 
assumed to be a call to a user-defined function. Reserved words 
include all BASIC commands, statements, function names and 
operator names. 


Variables may represent either a numeric value or a string. 


String variable names are written with a dollar sign ($) as the last 
character. For example: A$ = “SALES REPORT”. The dollar sign is a 
variable type declaration character, that is, it “declares” that the 
variable will represent a string. 


Numeric variable names may declare integer, single- or 
double-precision values. The type declaration characters for these 
variable names are as follows: 


% Integer variable 
! Single-precision variable 
# Double-precision variable 


The default type for a numeric variable name is single precision. 
Examples of MS-BASIC variable names follow. 


PI# declares a double-precision value 
MINIMUM! declares a single-precision value 
LIMIT% declares an integer value 

N$ declares a string value 

ABC represents a single-precision value 


1.6.2 ARRAY 
VARIABLES 


1.6.3 SPACE 
REQUIREMENTS 


DEE 
1.7 TYPE 
CONVERSION 


Example: 


There is a second method by which variable types may be declared. 
The MS-BASIC statements DEFINT, DEFSTR, DEFSNG and DEFDBL 
may be included in a program to declare the types for certain 
variable names. These statements are described in detail in Section 
2.10. 


An array is a group or table of values referenced by the same 
variable name. Each element in an array is referenced by an array 
variable that is subscripted with an integer or an integer expression. 
An array variable name has as many subscripts as there are 
dimensions in the array. For example V(10) would reference a value 
in a one-dimension array, T(1,4) would reference a value in a two- 
dimension array, and so on. The maximum number of dimensions for 
an array is 285. The maximum number of elements per dimension is 
32767. 


VARIABLES: BYTES 
Integer 2 
Single-precision 4 
Double-precision 8 

ARRAYS: BYTES 
Integer 2 per element 
Single-precision 4 per element 
Double-precision 8 per element 

STRINGS: 


3 bytes overhead plus the present contents of the string. 


When necessary, MS-BASIC will convert a numeric constant from one 
type to another. The following rules and examples should be kept in 
mind. 


1. If a numeric constant of one type is set equal to a 
numeric variable of a different type, the number will be 
stored as the type declared in the variable name. (If a 
string variable is set equal to a numeric value or vice 
versa, a "Type mismatch” error occurs.) 


AAA SO Mn EE 


10 A% = 23.42 
20 PRINT A% 
RUN 

RS 


2. During expression evaluation, all of the operands in an 
arithmetic or relational operation are converted to the 
same degree of precision, i.e., that of the most precise 
operand. Also, the result of an arithmetic operation is 
returned to this degree of precision. 


Examples: EE 


10 D* = 6#/7 The arithmetic was performed 

20 PRINT D* in double precision and the 

RUN result was returned in DH 
.857142857142857 1 as a double-precision value. 

10 D = 6#/7 The arithmetic was performed 

20 PRINT D in double precision and the 

RUN result was returned to D (single 
8571429 precision variable), rounded and 


printed as a single-precision value. 


3. Logical operators (see Section 1.8.3) convert their 
operands to integers and return an integer result. 
Operands must be in the range -32768 to 32767 or an 
“Overflow” error occurs. 


4. When a floating point value is converted to an integer, the 
fractional portion is rounded. 


Example: ques 


Example: 


a 
1.8 EXPRESSIONS 
AND OPERATORS 


10 C% = 55.88 
20 PRINT C% 
RUN 

56 


5. If a double-precision variable is assigned a single 
precision value, only the first seven digits, rounded, of the 
converted number will be valid. This is because only 
seven digits of accuracy were supplied with the single- 
precsion value. The absolute value of the difference 
between the printed double-precision number and the 
original single-precision value will be less than 6.3E-8 
times the original single-precision value. 


10 A = 2.04 

20 B¥ =A 

30 PRINT A; B# 

RUN 

2.04 2.039999961853027 


An expression may be a string or numeric constant, or a variable, or 
it may combine constants and variables with operators to produce a 
single value. 


Operators perform mathematical or logical operations on values. The 
operators provided by MS-BASIC may be divided into four categories: 


1. Arithmetic 


2. Relational 


3. Logical 


4. Functional 


1.8.1 ARITHMETIC The order of precedence of arithmetic operators is shown in Table 
OPERATORS 1-3: 


Table 1-3: Precedence Order of Arithmetic Operators 


SAMPLE 
OPERATOR OPERATION EXPRESSION 
° Exponentiation X*Y 
- Negation -X 
ri Multiplication, floating X*Y 
point division X/Y 
Es Addition, subtraction X+Y 


ESA e 


Use parentheses to change the order in which the operations are 
performed. Operations within parentheses are performed first. Inside 
parentheses, the usual order of operations is maintained. 


Here are some sample algebraic expressions and their MS-BASIC 
counterparts: 


Table 1-4: Algebraic Expressions and Their MS-BASIC 
Counterparts 


ALGEBRAIC EXPRESSION  MS-BASIC EXPRESSION 


X+2Y Ärd 
X-Y/Z X-Y/Z 
X (Y/Z) X*Y/Z 
AE 

Z (X+Y)/Z 
på)" (72) Y 
vi" X*(Y°Z) 

X(-Y) X*(-Y) 


NOTE: Two consecutive operators must be separated by parentheses. 
EEE EE ee a 


1.8.1.1 Integer 
Division and Modulus 
Arithmetic 


Example: 


Example: 


1.8.1.2 Overflow 
uy and Division By Zero 


1.8.2 RELATIONAL 
OPERATORS 


Two additional operators available in MS-BASIC are integer division 
and modulus arithmetic. 


Integer division is denoted by the backslash (\), ALT-+. The operands 
are rounded to integers (must be in the range 32768 to 32767) before 
the division is performed, and the quotient is truncated to an integer. 


1094 =8 
25.6816.99 = 3 


The precedence of integer division is just after that of multiplication 
and floating point division. 


Modulus arithmetic is denoted by the operator MOD. It gives the 
integer a value equal to the remainder of an integer division. 


10.4 MOD 4 = 2 (10/4=2 with a remainder 2) 
25.68 MOD 6.99 =5 (26/7=3 with a remainder 5) 


The precedence of modulus arithmetic is just after integer division. 


If a division by zero is encountered during the evaluation of an 
expression, the "Division by zero” error message is displayed, 
machine infinity with the sign of the numerator is supplied as the 
result of the division, and execution continues. If the evaluation of an 
exponentiation results in zero being raised to a negative power, the 
"Division by zero” error message is displayed, positive machine 
infinity is supplied as the result of the exponentiation, and execution 
continues. 


If overflow occurs, the “Overflow” error message is displayed, 
machine infinity with the algebraically correct sign is supplied as the 
result, and execution continues. 


Relational operators are used to compare two values. The result of 
the comparison is either “true” (-1) or “false” (0). This result may 
then be used to make a decision regarding program flow. (See 

IF, Section 2.25.) 


Table 1-5: Relational Operators 


OPERATOR RELATION TESTED EXPRESSION 
= Equality X=Y 
< > Inequality X< >Y 
< Less than X<Y 
> Greater than X>Y 
= Less than or equal to X<= 
= Greater than or equal to X>= 


Ve 


Example: 


Example: 


1.8.3 LOGICAL 
OPERATORS 


10 


NOTE: The equal sign is also used to assign a value to a variable. 
See LET, Section 2.29. 


When arithmetic and relational operators are combined in one 
expression, the arithmetic is always performed first. 


X+Y < (T-1)/Z 


is true if the value of X plus Y is less than the value of T-1 divided 


IF SIN(X)<0 GOTO 1000 
IF I MOD J < > O THEN K=K+1 


Logical operators perform tests on multiple relations, bit manipulation, 
or Boolean operations. The logical operator returns a bitwise result 
which is either "true" (not zero) or "false" (zero). In an expression, 
logical operations are performed after arithmetic and relational 
operations. The outcome of a logical operation is determined as 
shown in the following table. The operators are listed in order of 
precedence. 


Table 1-6: Outcomes of Logical Operations 


NOT 

X NOT X 
1 0 
0 


AND 
X AND Y 


00 
ooo 


OR 
X OR Y 


o o — —|x 
o= o |< 
O — — sch 


XOR 
X XOR Y 


o o = — |x 
O “0 


Example: 


Example: 


xX Y X EQV Y 
1 1 1 
1 0 0 
0 1 0 
0 0 1 
IMP 
x Y X IMP Y 
i 1 1 
1 0 0 
0 1 1 
0 0 1 


Just as the relational operators can be used to make decisions 
regarding program flow, logical operators can connect two or more 
relations and return a true or false value to be used in a decision 
(see IF, Section 2.26). 


IF D<200 AND F<4 THEN 80 
IF I>10 OR K<O THEN 50 
IF NOT P THEN 100 


eege 


Logical operators work by converting their operands to 16-bit, signed, 
two's complement integers in the range -32768 to +32767. (If the 
operands are not in this range, an error results.) If both operands are 
supplied as 0 or -1, logical operators return 0 or -1. The given 
operation is performed on these integers in bitwise fashion, i.e., each 
bit of the result is determined by the corresponding bits in the two 
operands. 


It is possible to use logical operators to test bytes for a particular bit 
pattern. For instance, the AND operator may be used to “mask” all 
but one of the bits of a status byte at a machine I/O port. The OR 
operator may be used to “merge” two bytes and create a particular 
binary value. The following examples will help demonstrate how the 
logical operators work. 


63 AND 16=16 63 = binary 111111 and 16 = binary 
10000, so 63 AND 16 = 16 


15 AND 14=14 15 = binary 1111 and 14 = binary 1000, 
so 15 AND 14 = 14 (binary 1110) 


-1 AND 8=8 -1 = binary 1111111111111111 and 8 = 
binary 1000, so -1 AND 8 = 8 


4 OR 2=6 4 = binary 100 and 2 = binary 10, so 4 
OR 2 = 6 (binary 110) 


1.8.4 FUNCTIONAL 
OPERATORS 


1.8.5 STRING 
OPERATIONS 
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Example: 


Examples: 


10 OR 10=10 10 = binary 1010, so 1010 OR 1010 = 
1010 (10) 


-1 OR -2=-1 -1 = binary 1111111111111111 and -2 = 
binary 1111111111111110, so -1 OR 
-2 = -1. The bit complement of sixteen 
zeros is sixteen ones, which is the two's 
complement representation of -1. 


NOT X= -(X+1) The two's complement of any integer is 
the bit complement plus one. 


eee 


A function is used in an expression to call a predetermined operation 
that is to be performed on an operand. MS-BASIC has “intrinsic” 
functions that reside in the system, such as SQR (square root) or SIN 
(sine). All MS-BASIC intrinsic functions are described in Chapter 3. 


MS-BASIC also allows “user defined” functions that are written by the 
programmer. (See DEF FN, Section 2.9.) | 


Strings may be concatenated using +. 


EEE AAA NE e 


10 A$="FILE" : B$="NAME" 
20 PRINT A$ + B$ 

30 PRINT "NEW ” + A$ + B$ 
RUN 

FILENAME 

NEW FILENAME 


E EEE reee, 


Strings may be compared using the same relational operators that are 
used with numbers: 


= <> < > <= >= 


String comparisons are made by taking one character at a time from 
each string and comparing the ASCII codes. If all the ASCII codes 
are the same, the strings are equal. If the ASCII codes differ, the 
lower code number precedes the higher. If, during string comparison, 
the end of one string is reached, the shorter string is said to be 
smaller. Leading and trailing blanks are significant. 


AA AAA NN EEE NS EE 


“AA” < “AB” 

“FILENAME” = “FILENAME” 

YEP” > NE 

“CL” > “OL” 

“kg” > “KG” 

“SMYTH” < “SMYTHE” 

B$ < “9/12/78” where B$ = "8/12/78" 


D 


a 
1.9 INPUT EDITING 


E 
1.10 ERROR 
MESSAGES 


Thus, string comparisons can be used to test string values or to 
alphabetize strings. All string constants used in comparison 
expressions must be enclosed in quotation marks. 


If an incorrect character is entered while typing a line, it can be 
deleted with the BACKSPACE key or with ALT-H. Once a character(s) 
has been deleted, simply continue typing the line as desired. 


To delete a line that is in the process of being typed, type ALT-U. A 
carriage return is executed automatically after the line is deleted. 


To correct program lines for a program that is currently in memory, 
simply retype the line using the same line number. MS-BASIC will 
automatically replace the old line with the new line. 


Section 2.15 “EDIT” describes more sophisticated editing capabilities 
provided in MS-BASIC. 


To delete the entire program that is currently residing in memory, 
enter the NEW command. (See Section 2.40.) NEW is usually used to 
clear memory prior to entering a new program. 


If MS-BASIC detects an error that causes program execution to halt, 
an error message is printed. For a complete list of MS-BASIC error 
codes and error messages, see Appendix G. 
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2.1 AUTO 


2. MS-BASIC COMMANDS AND STATEMENTS 


All MS-BASIC commands and statements are described in this 
chapter. Each description is formatted as follows: 


FORMAT: 


Shows the correct format for the instruction. See below for format 
notation. 


PURPOSE: 

Tells what the instruction is used for. 
REMARKS: 

Describes in detail how the instruction is used. 
EXAMPLE: 


Shows sample programs or program segments that demonstrate the 
use of the instruction. 


Wherever the format for a statement or command is given, the 
following rules apply: 


1. Items in capital letters must be input as shown. 


2. Items in lower case letters enclosed in angle brackets (< >) are 
to be supplied by the user. 


3. Items in square brackets ([ |) are optional. 

4. All punctuation except angle brackets and square brackets (ie. 
commas, parentheses, semicolons, hyphens, equal signs) must be 
included where shown. 

5. Items followed by an ellipsis ( . . . ) may be repeated any number 
of times (up to the length of the line). 

FORMAT: 

AUTO [<line number>[,</ncrement>]] 

PURPOSE: 


Generates a line number automatically after each carriage return, 
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2.2 CALL 
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REMARKS: 


AUTO begins numbering at </ine number> and increments each 
subsequent line number by <increment>. The default for both values 
is 10. If <line number> is followed by a comma but <increment> is 
not specified, the last increment specified in an AUTO command is 
assumed. 


If AUTO generates a line number that is already being used, an 
asterisk is printed after the number to warn the user that any input 
will replace the existing line. Typing a carriage return immediately 


after the asterisk will save the line and generate the next line number. 


AUTO is terminated by typing ALT-C. The line in which ALT-C is 
command level. 


EXAMPLE: 


AUTO 100, 50 Generates line numbers 100, 150, 200 ... 
AUTO Generates line numbers 10, 20, 30, 40 ... 


FORMAT: 
CALL <varlable name>[(<argument list>)] 


variable name contains the segment offset that is the starting point in 
memory of the subroutine being CALLed. Note that the variable name 
must be assigned to the segment offset before the CALL statement is 
issued (see example below). 


argument list contains the variables or constants, separated by 
commas, that are to be passed to the routine. 


PURPOSE: 
Calls an assembly language subroutine. 


REMARKS: 


The CALL statement is the recommended way of calling 8086 
machine language programs with MS-BASIC. It is suggested that the 
old style user-call USR(n) not be used. See Appendix E for 
comparison of the two methods and for a complete description of 
using the CALL statement for assembly language subroutines. 


When a CALL statement is executed, control is transferred to the 
user's routine via the segment address given in the last DEF SEG 
statement and the segment offset specified by the <variable name> 
portion of the CALL statement. Values are returned to MS-BASIC by 
including the variable name which will receive the result in the 
<argument list>. 


2.3 CHAIN 


The CALL statement conforms to the INTEL PL/M-86 calling 
conventions outlined in Chapter 9 of the INTEL PL/M-86 Compiler 
Operator's Manual. MS-BASIC follows the rules described for the 
MEDIUM case. 


EXAMPLE: 
100 DEF SEG=8H8000 


110 FOO=GH7FA 
120 CALL FOO (A,B$,C) 


Line 100 sets the segment address to 8000 Hex. The variable FOO is 
set to &H7FA, so that the call to FOO will execute the subroutine at 
location 8000:7FA Hex (absolute address 807FA Hex). 


FORMAT: 


CHAIN [MERGE] <filename>[,[</line number exp>] 
[¡ALL]J[,¡DELETE<range>]] 


PURPOSE: 

Calls a program and passes variables to it from the current program. 
REMARKS: 

<filename> is the name of the program that is called. 

EXAMPLE: 


CHAIN“PROG1” 


<line number exp> is a line number or an expression that evaluates 
to a line number in the called program. It is the starting point for 
execution of the called program. If it is omitted, execution begins at 
the first line. 


EXAMPLE: 


CHAIN" PROG 1”,1000 


<line number exp> is not affected by a RENUM command. 

With the ALL option, every variable in the current program is passed 
to the called program. If the ALL option is omitted, the current 
program must contain a COMMON statement to list the variables that 
are passed. (See Section 2.6.) 


EXAMPLE: 


CHAIN“PROG1”,1000, ALL 
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If the MERGE option is included, it allows a subroutine to be brought 
into the MS-BASIC program as an overlay. That is, a MERGE 
operation is performed with the current program and the called 
program. The called program must be an ASCII file if it is to be 
MERGEd. 


EXAMPLE: a 


CHAIN MERGE“OVRLAY”,1000 


After an overlay is brought in, it is usually desirable to delete it so 
that a new overlay may be brought in. To do this, use the DELETE 
option. 


EXAMPLE: 
CHAIN MERGE“OVRLAY2”,1000, DELETE 1000-5000 


The line numbers in <range> are affected by the RENUM command. 


NOTE: The CHAIN statement with MERGE option leaves the files 
open and preserves the current OPTION BASE setting. 


If the MERGE option is omitted, CHAIN won't preserve variable types 
or user-defined functions for use by the chained program. Any 
DEFINT, DEFSNG, DEFDBL, DEFSTR, or DEFFN statements 
containing shared variables must be restated in the chained program. 


The MS-BASIC compiler does not support the ALL, MERGE, DELETE, 

and <line number exp> options to CHAIN. Thus, the statement format d 
is CHAIN <filename>. If you wish to maintain compatibility with the 

MS-BASIC compiler, it is recommended that COMMON be used to 

pass variables and that overlays not be used. The CHAIN statement 

leaves the files open during CHAINing. 


When using the MERGE option, user-defined functions should be 
placed before any CHAIN MERGE statements in the program. 
Otherwise, the user-defined functions will be undefined after the 
merge is complete. 


EE EE 
2.4 CLEAR FORMAT: 


CLEAR [, [<expresslon1>][,<expresslon2>]] 
PURPOSE: 
Sets all numeric variables to zero, all string variables to null, and 


closes all open files; and, optionally, sets the end of memory and the 
amount of stack space. 


REMARKS: 


<expression! > is a memory location which, if specified, sets the 
highest location available for use by MS-BASIC. 


18 


2.5 CLOSE 


<expression2> sets aside stack space for MS-BASIC. The default is 
256 bytes or one-eighth of the available memory, whichever is 
smaller. 
NOTE: MS-BASIC allocates string space dynamically. An “Out of string 
space error” occurs only if there is no free memory left for MS-BASIC 
to use. 
The MS-BASIC Compiler supports the CLEAR statement with the 
restriction that <expressiont> and <expression2> must be integer 
expressions. If a value of 0 is given for either expression, the 
appropriate default is used. The default stack size is 256 bytes, and 
the default top of memory is the current top of memory. The CLEAR 
statement performs the following actions: 
» Closes all files 
> Clears all COMMON and user variables 
» Resets the stack and string space 
» Releases all disk buffers 
EXAMPLES: 

CLEAR 

CLEAR 32768 

CLEAR ,2000 


CLEAR ,32768,2000 


FORMAT: 

CLOSE[[#]<flle number [+]<flle number . ... >]] 
PURPOSE: 

Concludes I/O to a disk file. 

REMARKS: 


<file number> is the number under which the file was OPENed. A 
CLOSE with no arguments closes all open files. 


The association between a particular file and file number ends upon 
executing a CLOSE. The file may then be reOPENed using the same 
or a different file number. Likewise, that file number may now be 
reused to OPEN any file. 

A CLOSE for a sequential output file writes the final buffer of output. 


The END statement and the NEW command always CLOSEs all disk 
files automatically. (STOP does not close disk files.) 
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2.6 COMMON 
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EXAMPLE: 
See Appendix B, "MS-BASIC Disk 1/0." 


FORMAT: 

COMMON <iist of varlables> 
PURPOSE: 

Passes variables to a CHAINed program. 
REMARKS: 


The COMMON statement is used in conjunction with the CHAIN 
statement. COMMON statements may appear anywhere in a program, 
though it is recommended that they appear at the beginning. The 
same variable cannot appear in more than one COMMON statement. 
Array variables are specified by appending "( )” to the variable name. 
If all variables are to be passed, use CHAIN with the ALL option and 
omit the COMMON statement. 


EXAMPLE: 


100 COMMON A,B,C,D(),G$ 
110 CHAIN “PROG3”,10 


NOTE: The MS-BASIC Compiler supports a modified version of the 
COMMON statement. The COMMON statement must appear in a 
program before any executable statements. The current non- 
executable statements are: 


COMMON 

DEFDBL, DEFINT, DEFSNG, DEFSTR 
DIM 

OPTION BASE 

REM 

%INCLUDE 


Arrays in COMMON must be declared in preceding DIM statements, 


The standard form of the COMMON statement is referred to as blank 
COMMON. FORTRAN style named COMMON areas are also 
supported; however, the variables are not preserved across CHAINS. 
The syntax for named COMMON is as follows: 


COMMON <name> <list of variables> 


where <name> is 1 to 6 alphanumeric characters Starting with a 
letter. This is useful for communicating with FORTRAN and assembly 
language routines without having to explicitly pass parameters in the 
CALL statement. 


2.7 CONT 


The blank COMMON size and order of variables must be the same in 
the CHAINing and CHAINed-to programs. The best way to insure this 
is to place all blank COMMON declarations in a single include file 
and use the %INCLUDE statement in each program. 


EXAMPLE: 
MENU.BAS 
10 %INCLUDE COMDEF 
1000 CHAIN “PROG1” 
PROG1.BAS 
10 %INCLUDE COMDEF 
` 2000 CHAIN “MENU” 
COMDEF.BAS 
100 DIM A(100),B$(200) 
110 COMMON LJK A. ) 
120 COMMON A$,B$( )X¡Y,Z 
FORMAT: 
CONT 
PURPOSE: 


Continues program execution after an Alt-C has been typed, or a 
STOP or END statement has been executed. 


REMARKS: 


Execution resumes at the point where the break occurred. If the 
break occurred after a prompt from an INPUT statement, execution 
continues with the reprinting of the prompt (? or prompt string). 


CONT is usually used in conjunction with STOP for debugging. When 
execution is stopped, intermediate values may be examined and 
changed using direct mode statements. Execution may be resumed 
with CONT or a direct mode GOTO, which resumes execution at a 
specified line number. CONT may be used to continue execution after 
an error. 


CONT is invalid if the program has been edited during the break. 
EXAMPLE: 

10 Input A, B, C 

20 K=A"2*5.3:L=8" 3126 

30 STOP 


40 M=C*K+100:Print M 
RUN 
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2.8 DATA 
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? 12,83 
BREAK IN 30 
Ok 
Print L 
50.7692 
Ok 
CONT 
15.9 
Ok 


FORMAT: 
DATA <list of constants> 
PURPOSE: 


Stores the numeric and string constants that are accessed by the 
program's READ statement(s). (See READ, Section 2.53) 


REMARKS: 


DATA statements are nonexecutable and may be placed anywhere in 
the program. A DATA statement may contain as many constants as 
will fit on a line (separated by commas), and any number of DATA 
statements may be used in a program. The READ statements access 
the DATA statements in order (by line number) and the data 
contained in the DATA statements may be thought of as one 
continuous list of items, regardless of how many items are on a line 
or where the lines are placed in the program. 


<list of constants> may contain numeric constants in any format, Le, 
fixed point, floating point or integer. (No numeric expressions are 
allowed in the list.) String constants in DATA statements must be 
surrounded by double quotation marks only if they contain commas, 
colons or significant leading or trailing spaces. Otherwise, quotation 
marks are not needed. 


The variable type (numeric or string) given in the READ statement 
must agree with the corresponding constant in the DATA statement. 


DATA statements may be reread from the beginning by use of the 
RESTORE statement (Section 2.56). 


EXAMPLES: 


80 for I=1 TO 10 

90 READ A(I) 

100 NEXT I 

110 DATA 3.08,5.19,3.12,3.98,4.24 
120 DATA 5.08,5.55,4.00,3.16,3.37 


2.9 DEF FN 


This program segment READs the values from the DATA statements 
into the array A. After execution, the value of A(1) will be 3.08, and so 
on. 


LIST 

10 PRINT “CITY”, “STATE”, “ZIP” 

20 READ C$,S$,Z 

30 DATA “DENVER,”, COLORADO, 80211 
40 PRINT C$,5$,Z 


OK 

RUN 

CITY STATE ZIP 
DENVER, COLORADO 80211 
Ok 


This program READs string and numeric data from the DATA 
statement in line 30. 


FORMAT: 

DEF FN<name>[(<parameter list>)]=<function definition> 
PURPOSE: 

Defines and names a function that is written by the user. 
REMARKS: 


<name> must be a legal variable name. This name, preceded by FN, 
becomes the name of the function. <parameter list> is comprised of 
those variable names in the function definition that are to be replaced 
when the function is called. The items in the list are separated by 
commas. <function definition> is an expression that performs the 
operation of the function. It is limited to one line. Variable names that 
appear in this expression serve only to define the function; they do 
not affect program variables that have the same name. A variable 
name used in a function definition may or may not appear in the 
parameter list. If it does, the value of the parameter is supplied when 
the function is called. Otherwise, the current value of the variable is 
used. 


The variables in the parameter list represent — on a one-to-one basis 
— the argument variables or values that will be given in the function 
Call. 


User-defined functions may be numeric or string. If a type is specified 
in the function name, the value of the expression is forced to that 
type before it is returned to the calling statement. If a type is 
specified in the function name and the argument type does not 
match, a “Type mismatch” error occurs. 


A DEF FN statement must be executed before the function it defines 
may be called. If a function is called before it has been defined, an 
“Undefined user function" error occurs. DEF FN is illegal in the direct 
mode. 
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NAAA 
2.10 
DEFINT/SNG/DBL/STR 


2.11 DEF SEG 
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EXAMPLE: 


410 DEF FNAB(XY)=X"3/Y"2 
420 T=FNAB(IJ) 


Line 410 defines the function FNAB. The function is called in line 420. 


FORMAT: 

DEF<type> <range(s) of letters> 
where <type> is INT, SNG, DBL, or STR. 
PURPOSE: 


Declares variable types as integer, single-precision, double-precision, 
or string. 


REMARKS: 


A DEF<type> statement declares that the variable names beginning 
with the letter(s) specified will be that type variable. However, a type 
declaration character always takes precedence over a DEF<type> 
statement in the typing of a variable. 


If no type-declaration statements are encountered, MS-BASIC 
assumes all variables without declaration characters are single- 
precision variables. 


EXAMPLES: 

10 DEFDBL L-P All variables beginning with the letters 
L, M, N, O, and P will be double- 
precision variables. 

10 DEFSTR A All variables beginning with the letter A 
will be string variables. 

10 DEFINT I-N,W-Z All variable beginning with the letters I, 
J, K, L, M, N, W, X, Y, Z will be integer 
variables. 

FORMAT: 


DEF SEG [=<address>] 


where address is a valid numeric expression returning an unsigned 
integer in the range 0 to 65535. 


PURPOSE: 


Assigns the current segment address to be referenced by a 
subsequent CALL (see Section 2.2), a USR function call, or a PEEK 
or POKE statement. 


REMARKS: 


The address specified is saved for use as the segment required by 
PEEK, POKE, and CALL statements. 


Entry of any value outside the <address> range 0-65535 will result in 
an "Illegal Function Call” error, and the previous value will be 
retained. 


If the <address> option is omitted, the segment to be used is set to 
the MS-BASIC data segment (DS). This is the initial default value. 


If the <address> option is given, it should be based on a 16-byte 
boundary. For PEEK, POKE, or CALL statements, the value is shifted 
left 4 bits (this is done by the microprocessor, not by MS-BASIC) to 
form the code segment address for the subsequent call instruction. 
BASIC-86 does not perform additional checking to assure that the 
resultant segment address is valid. 


DEF and SEG MUST be separated by a space. Otherwise, MS-BASIC 
would interpret the statement DEFSEG=100 to mean, “assign the 
value 100 to the variable DEFSEG.” 


EXAMPLE: 
10 DEF SEG=8 HB800 SET segment to Screen buffer 
20 DEF SEG Restore segment to MS-BASIC DS 
A es) 
2.12 DEF USR FORMAT: 


DEF USR[<digit>]=<integer expresslon> 
PURPOSE: 


Specifies the starting address of an assembly language subroutine. 


REMARKS: 


<digit> may be any digit from 0 to 9. The digit corresponds to the 
number of the USR routine whose address is being specified. If 
<digit> is omitted, DEF USRO is assumed. The value of <integer 
expression> is the starting address of the USR routine. (See 
Appendix E, “Assembly Language Subroutines.”) 


Any number of DEF USR statements may appear in a program to 


redefine subroutine starting addresses, thus allowing access to as 
many subroutines as necessary. 
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2.13 DELETE 


2.14 DIM 
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EXAMPLE: 


200 DEF USRO=24000 
210 X=USRO (Y"2/2.89) 


FORMAT: 

DELETE[<line number>][-<line number>] 

PURPOSE: 

Deletes program lines. 

REMARKS: 

MS-BASIC always returns to command level after a DELETE is 


executed. If <line number> does not exist, an "Illegal function call" 
error occurs. 


EXAMPLES: 

DELETE 40 Deletes line 40 

DELETE 40-100 Deletes lines 40 through 100, inclusive 
DELETE40 Deletes all lines up to and including line 40 
FORMAT: 


DIM <iist of subscripted variables> 
PURPOSE: 


Specifies the maximum values for array variable subscripts and 
allocates storage accordingly. 


REMARKS: 


If an array variable name is used without a DIM statement, the 
maximum value of its subscript(s) is assumed to be 10. If a subscript 
is used that is greater than the maximum specified, a “Subscript out 
of range" error occurs. The minimum value for a subscript is always 
0, unless otherwise specified with the OPTION BASE statement (see 
Section 2.45). 


The DIM statement sets all the elements of the specified arrays to an 
initial value of zero. 


2.15 EDIT 


EXAMPLE: 


10 DIM A (20) 
20 FOR I=0 TO 20 
30 READ A (I) 
40 NEXT I 


FORMAT: 

EDIT <line number> 

PURPOSE: 

Enters Edit Mode at the specified line. 

REMARKS: 

In Edit Mode, it is possible to edit portions of a line without retyping 
the entire line. Upon entering Edit Mode, MS-BASIC types the line 
number of the line to be edited, and then types a space and waits for 
an Edit Mode subcommand. 

EDIT MODE SUBCOMMANDS 

Edit Mode subcommands are used to move the cursor or to insert, 
delete, replace, or search for text within a line. The subcommands are 
not echoed. Most of the Edit Mode subcommands may be preceded 


by an integer — causing the command to be executed that number of 
times. When a preceding integer is not specified, it is assumed to be 1. 


Edit Mode subcommands may be categorized according to the 
following functions: 


1. Moving the cursor 

2. Inserting text 

3. Deleting text 

4. Finding text 

5. Replacing text 

6. Ending and restarting Edit Mode 

NOTE: In the descriptions that follow, <ch> represents any character, 
<text> represents a string of characters of arbitrary length, [i] 


represents an optional integer (the default is 1), and ESC represents 
the Escape key. 
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1, 


Moving the Cursor 


Space: Use the space bar to move the cursor to the right. 
[iJSpace moves the cursor i spaces to the right. Characters are 
printed as you space over them. 


Backspace: In Edit Mode, the Backspace moves the cursor key 
one space to the left each time it is pressed. Characters are 
printed as you backspace over them. 


Inserting Text 


I<text> inserts <text> at the current cursor position. The 
inserted characters are printed on the terminal. To terminate 
insertion, type Escape. If Carriage Return is typed during an 
Insert command, the effect is the same as typing Escape 
and then Carriage Return. During an Insert command, the 
Backspace key on the terminal may be used to delete 
characters to the left of the cursor for each character that 
you backspace over. lí an attempt is made to insert a 
character that will make the line longer than 255 characters, 
a bell (Alt-G) is typed and the character is not printed. 


The X subcommand is used to extend the line. X moves the 
cursor to the end of the line, goes into insert mode, and 
allows insertion of text as if an Insert command had been 
given. When you are finished extending the line, type 
Escape or Carriage Return. 


Deleting Text 


D 


[i]D deletes i characters to the right of the cursor. The 
deleted characters are echoed between backslashes, and 
the cursor is positioned to the right of the last character 
deleted. lf there are fewer than ¡ characters to the right of 
the cursor, ID deletes the remainder of the line. 


H deletes all characters to the right of the cursor and 
then automatically enters insert mode. H is useful for 
replacing statements at the end of a line. 


Finding Text 


S 


The subcommand [i]S<ch> searches for the ith occurrence 
of <ch> and positions the cursor before it. The character at 
the current cursor position is not included in the search. If 
<ch> is not found, the cursor will stop at the end of the 
line. All characters passed over during the search are 
printed. 


The subcommand [i]JK<ch> is similar to [i]JS<ch>, except 
all the characters passed over in the search are deleted. 
The cursor is positioned betore <ch>, and the deleted 
characters are enclosed in backslashes. 


5. Replacing Text 


Cc The subcommand C<ch> changes the next character to 
<ch>. If you wish to change the next i characters, use the 
subcommand iC, followed by i characters. After the ith new 
character is typed, change mode is exited and you will 
return to Edit Mode. 


6. Ending and Restarting Edit Mode 


<er> Typing Carriage Return prints the remainder of the line, 
saves the changes you made and exits Edit Mode. 


E The E subcommand has the same effect as Carriage 
Return, except the remainder of the line is not printed. 


Q The Q subcommand returns to MS-BASIC command level, 
without saving any of the changes that were made to the 
line during Edit Mode. 


L The L subcommand lists the remainder of the line (saving 
any changes made so far) and repositions the cursor at the 
beginning of the line, still in Edit Mode. L is usually used to 
list the line when you first enter Edit Mode. 


A The A subcommand lets you begin editing a line over again. 
It restores the original line and repositions the cursor at the 
beginning. 


NOTE: If MS-BASIC receives an unrecognizable command or 
illegal character while in Edit Mode, it prints a bell character 
(Alt-G) and the command is ignored. 


SYNTAX ERRORS 


When a Syntax Error is encountered during execution of a program, 
MS-BASIC automatically enters Edit Mode at the line that caused the 
error. 


EXAMPLE: 
10 K = 2(4) 
RUN 
?Syntax error in 10 
10 


When you finish editing the line and type Carriage Return (or the E 
subcommand), MS-BASIC reinserts the line, which causes all variable 
values to be lost. To preserve the variable values for examination 
first exit Edit Mode with the Q subcommand. MS-BASIC will return to 
command level, and all variable values will be preserved. 
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2.16 END 


2.17 ERASE 
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ALT-A 


Type an Alt-A to enter Edit Mode on the line you are currently typing. 
MS-BASIC responds with a carriage return, an exclamation point (!) 
and a space. The cursor will be positioned at the first character in the 
line. Proceed by typing an Edit Mode subcommand. 


NOTE: Remember, if you have just entered a line and wish to go 
back and edit it, the command "EDIT." will enter Edit Mode at the 
current line. (The line number symbol "." always refers to the 
current line.) 


FORMAT: 
END 
PURPOSE: 


Terminates program execution, closes all files and returns to 
command level. 


REMARKS: 
END statements may be placed anywhere in the program. Unlike the 
STOP statement, END does not cause a BREAK message to be 
printed. An END statement at the end of a program is optional. 
MS-BASIC always returns to command level after an END is executed. 
EXAMPLE: 

520 IF K>1000 THEN END ELSE GOTO 20 
FORMAT: 
ERASE <list of array varlables> 
PURPOSE: 
Eliminates arrays from a program. 
REMARKS: 
Arrays may be redimensioned after they are ERASEd, or the 
previously allocated array space in memory may be used for other 
purposes. If an attempt is made to redimension an array without first 
ERASEing it, a "Duplicate Definition" error occurs. 


NOTE: The MS-BASIC compiler does not support ERASE. 
EXAMPLE: 


450 ERASE A, B 
460 DIM B(99) 


